Developer Documentation
PATH  WebObjects 4.0 Documentation > Serving WebObjects

Table of Contents Previous Section

Starting and Stopping an Application Instance

You start an instance from the Application Detail View page. To get to this page, click Applications in the top banner, then click the Detail View button in the row of the instance you wish to start. If you have just added an application instance, and are in the Application Configuration page for the application, click the Detail View button at the top right of the page. A page similar to the following should then appear:

The button that looks like a power switch reports the current state of your instance: ON or OFF. The rest of the table reports other information about your instance (for more details see "Obtaining Information From Monitor" on ).

  1. Click the power switch.

    The Detail View page is refreshed and the power switch appears in an animated toggle state, signifying that Monitor is trying to start your instance.

  2. After a few seconds, click the Refresh button.

    Monitor will refresh the Detail View page and with success your instance will be running and the power switch will be on.

If successful, this procedure starts an instance of the application but does not display it in the web browser. When one or more instances are running, the name of the application above the table of instances turns green, becoming a hyperlink that, when clicked, access an instance of the application. In addition, the host name and port number for each instance also become hyperlinks; clicking one of these accesses a specific instance.

If after completing the startup procedure, the instance's power switch is off, it might be due to one of the following reasons:

Monitor starts an instance of your application by creating a new task with the executable; it passes along all the appropriate arguments from the Instance Configuration page for that instance. Monitor starts instances of your application in one of two ways, depending on whether the application is on a different host.

Clicking the Status switch for an instance when it is ON stops the instance. Clicking the Start All button causes Monitor to attempt to start all application instances that are currently stopped; clicking the Stop All button causes Monitor to stop all instances that are currently running.

Table of Contents Next Section